Removes black specks from 1 bit images.
→ 
The uncompressed image to be processed must reside in the Get Queue prior to REQ_EXEC. Typically, the image will be fully contained in the Get Queue, but that is not a requirement. The output image will be placed into the Put Queue during REQ_EXEC.
Padding pixels present at the end of each line may be modified by this operation.
- Subcode is set to SF_SUBCODE_DESPECKLE (1).
- u.SC1.SpeckWidth is set to the maximum width of specks to remove from the image. Any black objects greater than this width will remain in the output image. Valid values are 1 to 100. Typically, this should be set to slightly less than the width of a period character.
- u.SC1.SpeckHeight is set to the maximum height of specks to remove from the image. Any black objects greater than this height will remain in the output image. Valid values are 1 to 100. Typically, this should be set to slightly less than the height of a period character.
- Stride is set to the image line width in bytes including padding at the end of the line width or to 0. If Stride is 0 and PF_NoDibPad is set in PicFlags, the operation will compute the stride using: [ (PixelWidth*BitCount)/8 ]. If Stride is 0 and PF_NoDibPad is not set in PicFlags, the operation will compute the stride using: [ (((PixelWidth*BitCount)+31)&(~31))/8 ].
In addition to placing an output image into the Put Queue, this operation stores some output information into the PIC_PARM structure in the following locations.
- CountOfFeaturesDetected is set, during REQ_EXEC, to the number of specks removed.
- OutputStride is set, during REQ_INIT and REQ_EXEC, to the image line width in bytes including padding at the end of the line.
- BiOut is set, during REQ_INIT and REQ_EXEC, to the attributes of the output image. Since this operation does not adjust the size of the image, BiOut will be set to a copy of the Head structure within PIC_PARM.
